home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_hylafax.idb / usr / freeware / man / cat1 / faxmail.Z / faxmail
Encoding:
Text File  |  1999-07-16  |  32.0 KB  |  659 lines

  1.  
  2.  
  3.  
  4. FFFFAAAAXXXXMMMMAAAAIIIILLLL((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuullllyyyy 22222222,,,, 1111999999996666))))        FFFFAAAAXXXXMMMMAAAAIIIILLLL((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      faxmail - _H_y_l_a_F_A_X mail-to-fax gateway application
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ffffaaaaxxxxmmmmaaaaiiiillll [ _o_p_t_i_o_n_s ] [ _d_e_s_t_i_n_a_t_i_o_n [ _f_r_o_m ] ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _f_a_x_m_a_i_l takes an electronic mail message on standard input
  16.      and converts it to POSTSCRIPT in a form that is suitable for
  17.      transmission as a facsimile.  The converted document is
  18.      either written to the standard output or, if direct delivery
  19.      is enabled, it is submitted directly to a _H_y_l_a_F_A_X server for
  20.      transmission.
  21.  
  22.      _f_a_x_m_a_i_l is designed for use in constructing electronic mail
  23.      to facsimile gateway services.  For example, mail aliases
  24.      may be created to automatically transmit electronic mail;
  25.      e.g.
  26.  
  27.           sam: "|/usr/freeware/bin/faxmail -d sam@5551212"
  28.      or _f_a_x_m_a_i_l may be used as a ``mail transport agent'',
  29.      extracting the necessary delivery information directly from
  30.      the envelope of the mail message.
  31.  
  32.      If _f_a_x_m_a_i_l is invoked without enabling direct delivery then
  33.      it just formats the mail message on the standard input and
  34.      writes the result to the standard output.  To enable direct
  35.      delivery the ----dddd option must be specified on the command
  36.      line; see below for more information.
  37.  
  38. FFFFOOOORRRRMMMMAAAATTTTTTTTIIIINNNNGGGG
  39.      _f_a_x_m_a_i_l formats a mail message according to the following
  40.      rules:  First it parses the envelope information
  41.      interpreting any meta-header information (see below) that is
  42.      present.  Once the entire envelope has been collected it
  43.      emits a formatted set of header lines.  By default all
  44.      header information except the ``From'', ``To'', ``Cc'',
  45.      ``Subject'', and ``Date'' lines are discarded.  Header lines
  46.      that are kept have the _t_a_g (the string to the left of the
  47.      ``:'')  set in a _b_o_l_d _f_o_n_t and the _v_a_l_u_e (the string to the
  48.      right of the ``:'')  set in an _i_t_a_l_i_c _f_o_n_t.  Mail messages
  49.      that conform to the Multipurpose Internet Mail Extensions
  50.      (MIME) specification are parsed and handled according to the
  51.      rules given below.  Plain text body parts of a mail message
  52.      are formatted in a _t_e_x_t _f_o_n_t with any long lines wrapped at
  53.      word boundaries unless the ----cccc option has been specified.
  54.  
  55.      By default, _f_a_x_m_a_i_l sets all text in 10 point type on an
  56.      8.5" by 11" portrait-oriented page with .35" top margin,
  57.      .25" bottom margin and .25" left and right hand margins.
  58.      There are command-line options to control the point size,
  59.      page dimensions, orientation, and multi-column formatting.
  60.  
  61.  
  62.  
  63. Page 1                                          (printed 6/24/99)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. FFFFAAAAXXXXMMMMAAAAIIIILLLL((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuullllyyyy 22222222,,,, 1111999999996666))))        FFFFAAAAXXXXMMMMAAAAIIIILLLL((((1111))))
  71.  
  72.  
  73.  
  74.      Text formatting can also be controlled through meta-header
  75.      directives placed in the envelope of the mail message.
  76.  
  77. EEEENNNNVVVVEEEELLLLOOOOPPPPEEEE PPPPRRRROOOOCCCCEEEESSSSSSSSIIIINNNNGGGG
  78.      _f_a_x_m_a_i_l pre-processes the envelope information (i.e. the
  79.      header lines) before formatting the message contents.
  80.      Header lines whose names begin with ``X-FAX-'' (case-
  81.      insensitive) are handled specially-they are treated as
  82.      command directives that specify how to generate the
  83.      resultant POSTSCRIPT or, optionally, how to deliver the
  84.      resulting document as facsimile.  The set of known meta-
  85.      headers corresponds to the set of configuration parameters
  86.      defined below.  A meta-header is specified as ``X-FAX-
  87.      _p_a_r_a_m_e_t_e_r'' where _p_a_r_a_m_e_t_e_r is the name of a configuration
  88.      parameter; e.g.  ``X-FAX-TabStop'' to set the number of
  89.      spaces between tab stops.
  90.  
  91.      Controls for specifying headers to be passed through in the
  92.      formatted text identify not only which headers but also the
  93.      order in which the headers should be emitted.  _f_a_x_m_a_i_l
  94.      initializes the set of headers to retain to: ``To From
  95.      Subject Cc Date''.  If this order is acceptable then
  96.      additional headers can simply be added with the X-FAX-
  97.      Headers directive; e.g. ``X-FAX-Headers: Message-id''.  If
  98.      however a different order is desired then the header set
  99.      should be cleared with a ``clear'' header tag and then
  100.      completely specified in the desired order; for example,
  101.  
  102.      X-FAX-Headers: clear Message-id Date To Subject From Cc
  103.  
  104.      will cause headers to be emitted in the order ``Message-Id
  105.      Date To Subject From Cc'' (depending on what headers are
  106.      present).  Note in particular that all header lines in the
  107.      envelope can be suppressed by specifying ``X-FAX-Headers:
  108.      clear''; this is useful, for example, when the body of the
  109.      mail message contains a preformatted document that is to be
  110.      transmitted.
  111.  
  112.      In addition to the above controls, _f_a_x_m_a_i_l can also be
  113.      instructed to substitute an arbitrary string for a header
  114.      tag when generating the final envelope.  This facility can
  115.      be used to better format ad-hoc header information that is
  116.      passed through the envelope of the message.  The ``X-FAX-
  117.      MapHeader'' meta-header specifies how to map a header line.
  118.      For example,
  119.  
  120.      X-FAX-MapHeader: x_FAX_For Deliver FAX To
  121.  
  122.      would cause any header ``x_FAX_For'' that appeared in the
  123.      envelope to be replaced in the formatted envelope by
  124.      ``Deliver FAX To''.
  125.  
  126.  
  127.  
  128.  
  129. Page 2                                          (printed 6/24/99)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. FFFFAAAAXXXXMMMMAAAAIIIILLLL((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuullllyyyy 22222222,,,, 1111999999996666))))        FFFFAAAAXXXXMMMMAAAAIIIILLLL((((1111))))
  137.  
  138.  
  139.  
  140. MMMMIIIIMMMMEEEE PPPPRRRROOOOCCCCEEEESSSSSSSSIIIINNNNGGGG
  141.      _f_a_x_m_a_i_l parses MIME mail messages and does some rudimentary
  142.      work to:
  143.  
  144.      +o  strip out unprintable content such as audio, video, or
  145.         binary data,
  146.  
  147.      +o  decode encoded parts,
  148.  
  149.      +o  insert ``digest dividers'' between multipart/digest
  150.         subparts,
  151.  
  152.      +o  format message/rfc822 parts as described above for the
  153.         top-level envelope, and
  154.  
  155.      +o  optionally convert graphical parts (e.g. images) for
  156.         display.
  157.  
  158.      MIME processing is fairly simple and (currently) somewhat
  159.      constrained.  _f_a_x_m_a_i_l has builtin support for the following
  160.      MIME parts:  text/plain, multipart/mixed, multipart/digest,
  161.      message/rfc822, application/postscript, and application/x-
  162.      faxmail-prolog.  Parts can also be processed through
  163.      external processing scripts that _f_a_x_m_a_i_l looks for in a
  164.      ``MIME converters'' directory hierarchy.  External scripts
  165.      may override builtin processing or supplement the builtin
  166.      support.  For each MIME body part with type _T and subtype _S
  167.      _f_a_x_m_a_i_l checks first for an executable script named T/S in
  168.      the converter hierarchy.  If a script exists then it is run
  169.      and the result is appended to the output PostScript
  170.      document.  Otherwise if the part has builtin support then it
  171.      is processed directly.  Any part that does not have external
  172.      or builtin support is discarded and replaced by a message
  173.      that indicates the part was removed.  This discarded message
  174.      can be suppressed with the _M_a_r_k_D_i_s_c_a_r_d_e_d configuration
  175.      parameter (also settable with an X-FAX-MarkDiscarded line in
  176.      the envelope).
  177.  
  178.      The builtin handling support is as follows:  text/plain
  179.      parts are formatted using the default _t_e_x_t _f_o_n_t and point
  180.      size; multipart/mixed are ``burst'' and interpreted per the
  181.      specification but are otherwise unformatted;
  182.      multipart/digest are burst and an optional ``digest
  183.      divider'' marking may be inserted before each subpart;
  184.      message/rfc822 are formatted as described above with
  185.      envelope header lines culled and formatted with bold and
  186.      italic fonts (in addition, if there is insufficient space in
  187.      the current output page/column for the message envelope,
  188.      optional divider, and one line of text, then _f_a_x_m_a_i_l will
  189.      insert a ``break'' so the the message starts at the top of
  190.      the next page/column); application/postscript are copied
  191.      through untouched to the output; application/x-faxmail-
  192.  
  193.  
  194.  
  195. Page 3                                          (printed 6/24/99)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. FFFFAAAAXXXXMMMMAAAAIIIILLLL((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuullllyyyy 22222222,,,, 1111999999996666))))        FFFFAAAAXXXXMMMMAAAAIIIILLLL((((1111))))
  203.  
  204.  
  205.  
  206.      prolog are copied through untouched to the end of the
  207.      prologue section of the generated PostScript document to
  208.      permit customization of the formatted output.
  209.  
  210.      _f_a_x_m_a_i_l supports the following Content-Transfer-Encoding
  211.      schemes:  7bit, 8bit, binary, base64, quoted-printable, and
  212.      x-uuencode.  Any character set that is not us-ascii is
  213.      treated as iso-8859-1.
  214.  
  215.      In general it is recommended that senders either permit
  216.      _f_a_x_m_a_i_l to format message contents or completely bypass the
  217.      formatting facilities and submit data that is to be
  218.      processed by _s_e_n_d_f_a_x.  Trying to combine the two facilities
  219.      by, for example, combining PostScript with text that is to
  220.      be formatted is unlikely to work well because _f_a_x_m_a_i_l does
  221.      not track the amount of space on the page that a non-text
  222.      MIME part uses.
  223.  
  224. DDDDIIIIRRRREEEECCCCTTTT DDDDEEEELLLLIIIIVVVVEEEERRRRYYYY
  225.      When _f_a_x_m_a_i_l is invoked with the ----dddd option it delivers the
  226.      formatted document directly to a _H_y_l_a_F_A_X server for
  227.      transmission as facsimile.  Command line arguments may be
  228.      supplied to specify the delivery destination and sender
  229.      identity; typically from information extracted by the mail
  230.      transport facility.  A command line _d_e_s_t_i_n_a_t_i_o_n is specified
  231.      with the same syntax as the argument for the ----dddd option to
  232.      the _s_e_n_d_f_a_x(1) command.  Similarly any _f_r_o_m identity
  233.      specified on the command line follows the same rules as the
  234.      ----ffff option to _s_e_n_d_f_a_x.  An explicit dialstring to use in
  235.      delivery can also be specified with an X-FAX-Dialstring
  236.      header in the mail message envelope.  If no sender identity
  237.      is provided on the command line then _f_a_x_m_a_i_l will extract it
  238.      from the ``From'' line in the envelope.  _f_a_x_m_a_i_l will not
  239.      submit a message for delivery if either the dialstring or
  240.      sender identity is missing or null.
  241.  
  242.      When direct delivery is enabled X-FAX- header lines may be
  243.      included in the mail message envelope to control the
  244.      submission and delivery process.  As above these lines are
  245.      specified as ``X-FAX-_p_a_r_a_m_e_t_e_r'' where _p_a_r_a_m_e_t_e_r is the name
  246.      of a configuration parameter for the _s_e_n_d_f_a_x program; e.g.
  247.      ``X-FAX-VRes'' to set the vertical resolution of the
  248.      transmitted facsimile.  By default automatic cover page
  249.      generation is enabled when direct delivery is used; this can
  250.      be overridden with the ----nnnn option on the command line or by
  251.      including an X-FAX-AutoCoverPage header in the message
  252.      envelope.
  253.  
  254. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  255.      ----1111        Set text in one column (default).
  256.  
  257.      ----2222        Set text two columns.
  258.  
  259.  
  260.  
  261. Page 4                                          (printed 6/24/99)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. FFFFAAAAXXXXMMMMAAAAIIIILLLL((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuullllyyyy 22222222,,,, 1111999999996666))))        FFFFAAAAXXXXMMMMAAAAIIIILLLL((((1111))))
  269.  
  270.  
  271.  
  272.      ----bbbb _f_o_n_t   Make _f_o_n_t, a POSTSCRIPT font name, the ``_b_o_l_d
  273.                _f_o_n_t'' used to set header lines.  The default bold
  274.                font is Helvetica-Bold.
  275.  
  276.      ----cccc        Clip long text lines instead of wrapping them at
  277.                page margins.
  278.  
  279.      ----dddd        Enable direct delivery of facsimile; the formatted
  280.                document will be submitted directly to a _H_y_l_a_F_A_X
  281.                server for transmission as facsimile.  This option
  282.                is similar to piping the output of _f_a_x_m_a_i_l to the
  283.                input of _s_e_n_d_f_a_x(1M) except when direct delivery
  284.                is enabled _f_a_x_m_a_i_l interprets ``x-fax-'' header
  285.                lines in the envelope of the mail message to look
  286.                for control information to use in delivering the
  287.                facsimile and, by default, no automatic cover page
  288.                generation is done.
  289.  
  290.      ----ffff _f_o_n_t   Make _f_o_n_t, a POSTSCRIPT font name, the text font
  291.                used to set the body of mail messages.  The
  292.                default text font is Courier.
  293.  
  294.      ----HHHH _h_e_i_g_h_t Use _h_e_i_g_h_t as the height, in inches, of the output
  295.                page.  The default page height is taken from the
  296.                default page size.
  297.  
  298.      ----iiii _f_o_n_t   Make _f_o_n_t, a POSTSCRIPT font name, the ``_i_t_a_l_i_c
  299.                _f_o_n_t'' used to set header lines.  The default
  300.                italic font is Helvetica-Oblique.
  301.  
  302.      ----MMMMllll====#,rrrr====#,tttt====#,bbbb====#
  303.                Set the page margins; the default margins are:
  304.                left and right .25 inch, top .35 inch, bottom .25
  305.                inch.
  306.  
  307.      ----nnnn        Suppress auto cover page generation when doing
  308.                direct delivery.
  309.  
  310.      ----pppp _s_i_z_e   Set all text using _s_i_z_e for the font point size.
  311.  
  312.      ----rrrr        Set pages rotated by 90 degrees (in ``Landscape
  313.                mode'').
  314.  
  315.      ----RRRR        Set pages unrotated (in ``Portrait mode'').
  316.  
  317.      ----ssss _s_i_z_e   Set the page size to use.  Cover pages are
  318.                normally generated using a system-default page
  319.                size (usually letter-size pages, 8.5" by 11", for
  320.                sites in North America).  Alternate page sizes are
  321.                specified symbolically using either the name or
  322.                abbreviation of an entry in the _p_a_g_e_s_i_z_e_s(4F)
  323.                database; e.g.  _a_3 (ISO A3), _a_4 (ISO A4), _a_5 (ISO
  324.  
  325.  
  326.  
  327. Page 5                                          (printed 6/24/99)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. FFFFAAAAXXXXMMMMAAAAIIIILLLL((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuullllyyyy 22222222,,,, 1111999999996666))))        FFFFAAAAXXXXMMMMAAAAIIIILLLL((((1111))))
  335.  
  336.  
  337.  
  338.                A5), _a_6 (ISO A6), _b_4 (ISO B4), _n_a-_l_e_t (North
  339.                American Letter), _u_s-_l_e_g (American Legal), _u_s-_l_e_d
  340.                (American Ledger), _u_s-_e_x_e (American Executive),
  341.                _j_p-_l_e_t (Japanese Letter), and _j_p-_l_e_g (Japanese
  342.                Legal).  Comparisons are case-insensitive and any
  343.                match of a substring of the full page-size name is
  344.                sufficient; e.g. ``legal'' would match ``American
  345.                Legal''.
  346.  
  347.      ----uuuu _u_s_e_r   Set the user name to use when logging in to do
  348.                direct delivery.  By default the user is specified
  349.                by the MMMMaaaaiiiillllUUUUsssseeeerrrr configuration parameter (see
  350.                below).  If a null user name is specified, then
  351.                the facsimile will be submitted using the identity
  352.                of the user that invoked _f_a_x_m_a_i_l.
  353.  
  354.      ----vvvv        Enable tracing of envelope, MIME, and job
  355.                submission processing.  Diagnostic information is
  356.                written to the standard error (envelope and MIME
  357.                processing) and standard output (job submission).
  358.  
  359.      ----WWWW _w_i_d_t_h  Use _w_i_d_t_h as the width, in inches, of the output
  360.                page.  The default page width is taken from the
  361.                default page size.
  362.  
  363. CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  364.      _f_a_x_m_a_i_l reads configuration information from the files
  365.      ////uuuussssrrrr////ffffrrrreeeeeeeewwwwaaaarrrreeee////lllliiiibbbb////ffffaaaaxxxx////hhhhyyyyllllaaaa....ccccoooonnnnffff, and ~~~~////....hhhhyyyyllllaaaarrrrcccc; in that
  366.      order.  Configuration files follow the conventions described
  367.      in _h_y_l_a_f_a_x(1).  The following configuration parameters are
  368.      recognized:
  369.      TTTTaaaagggg               TTTTyyyyppppeeee         DDDDeeeeffffaaaauuuulllltttt              DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  370.      AutoCoverPage     boolean      Yes                  automatically generate cover page
  371.      BoldFont          string       Helvetica-Bold       font for setting header tags
  372.      Columns           integer      1                    number of columns in formatted output
  373.      DigestDivider     string       -                    multipart/digest divider POSTSCRIPT command
  374.      FontDir           string       _s_e_e _b_e_l_o_w            directory for font metric files
  375.      GaudyHeaders      boolean      No                   enable/disable gaudy page headers
  376.      Headers           string       _s_e_e _b_e_l_o_w            headers to retain in envelope
  377.      ISO8859           boolean      Yes                  use ISO 8859-1 character encoding
  378.      ItalicFont        string       Helvetica-Oblique    font for setting header values
  379.      LineWrap          boolean      Yes                  wrap/truncate text lines
  380.      MailUser          string       -                    user identity for doing direct delivery
  381.      MarkDiscarded     boolean      Yes                  mark discarded MIME body parts
  382.      MapHeader         string       -                    define header mapping
  383.      MIMEConverters    string       _s_e_e _b_e_l_o_w            pathname of MIME converter scripts
  384.      Orientation       string       portrait             orientation of text on page
  385.      OutlineMargin     inches       0                    width of outline line
  386.      PageCollation     string       forward              collate pages in forward or reverse direction
  387.      PageHeaders       boolean      Yes                  enable/disable page headers
  388.      PageHeight        float        -                    output page height
  389.      PageMargins       string       _s_e_e _b_e_l_o_w            margins for formatted page
  390.  
  391.  
  392. Page 6                                          (printed 6/24/99)
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399. FFFFAAAAXXXXMMMMAAAAIIIILLLL((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuullllyyyy 22222222,,,, 1111999999996666))))        FFFFAAAAXXXXMMMMAAAAIIIILLLL((((1111))))
  400.  
  401.  
  402.  
  403.      PageSize          string       default              output page size from database
  404.      PageWidth         float        -                    output page width
  405.      Prologfile        string       _s_e_e _b_e_l_o_w            pathname of POSTSCRIPT prologue file
  406.      TabStop           integer      8                    inter-stop setting in characters
  407.      TextFont          string       Courier              name of font for setting text
  408.      TextLineHeight    inches       -                    text formatting line height control
  409.      TextPointSize     inches       _s_e_e _b_e_l_o_w            size to use in setting text
  410.      Verbose           boolean      No                   trace envelope and MIME processing
  411.  
  412.      Values marked as _i_n_c_h_e_s are specified using a syntax that
  413.      identifies one of several possible units:
  414.           #.##bp    big point (1in = 72bp)
  415.           #.##cc    cicero (1cc = 12dd)
  416.           #.##cm    centimeter
  417.           #.##dd    didot point (1157dd = 1238pt)
  418.           #.##in    inch
  419.           #.##mm    millimeter (10mm = 1cm)
  420.           #.##pc    pica (1pc = 12pt)
  421.           #.##pt    point (72.27pt = 1in)
  422.           #.##sp    scaled point (65536sp = 1pt)
  423.  
  424.      Unit names can be upper or lower case but no white space is
  425.      permitted between the number and the unit.  Values specified
  426.      with no unit are interpreted as points.
  427.  
  428.      The configuration parameters are explained below.  Most
  429.      parameters correspond to a command line option.  Parameter
  430.      values identified above as _i_n_c_h_e_s are converted according to
  431.      the conventions described above.
  432.  
  433.      AAAAuuuuttttooooCCCCoooovvvveeeerrrrPPPPaaaaggggeeee  Control whether or not a cover page is
  434.                     automatically generated for each job.
  435.  
  436.      BBBBoooollllddddFFFFoooonnnntttt       The name of the font to use to set header
  437.                     tags (i.e. the string to the left of the
  438.                     ``:'').
  439.  
  440.      CCCCoooolllluuuummmmnnnnssss        The number of columns to set text in.
  441.                     (Equivalent to the ----mmmm option.)
  442.  
  443.      DDDDiiiiggggeeeessssttttDDDDiiiivvvviiiiddddeeeerrrr  The string to emit in the output before each
  444.                     subpart of a multipart/digest mail message.
  445.                     This string is typically a POSTSCRIPT
  446.                     procedure that draws a mark of some sort.
  447.                     Dividers are expected to use no more vertical
  448.                     space on the output page than a line of text.
  449.  
  450.      FFFFoooonnnnttttDDDDiiiirrrr        The directory where Adobe Font Metric (AFM)
  451.                     files are located; by default
  452.                     /usr/lib/DPS/AFM.
  453.  
  454.  
  455.  
  456. Page 7                                          (printed 6/24/99)
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463. FFFFAAAAXXXXMMMMAAAAIIIILLLL((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuullllyyyy 22222222,,,, 1111999999996666))))        FFFFAAAAXXXXMMMMAAAAIIIILLLL((((1111))))
  464.  
  465.  
  466.  
  467.      GGGGaaaauuuuddddyyyyHHHHeeeeaaaaddddeeeerrrrssss   Control whether or not to use a gaudy-style
  468.                     page header.  Enabling gaudy headers
  469.                     implicitly enables page headers.
  470.  
  471.      HHHHeeeeaaaaddddeeeerrrrssss        Define the headers retained from the envelope
  472.                     and specify the order that they should be
  473.                     emitted in the formatted output.  The set of
  474.                     headers is initialized to ``To From Subject
  475.                     Cc Date''.  Headers specified are appended to
  476.                     this list except for a ``clear'' header that
  477.                     causes the current set of headers to be
  478.                     discarded.
  479.  
  480.      IIIISSSSOOOO8888888855559999        Control the use of ISO 8859-1 encoding in the
  481.                     generated POSTSCRIPT
  482.  
  483.      IIIIttttaaaalllliiiiccccFFFFoooonnnntttt     The name of the font to use to set header
  484.                     values (i.e. the string to the right of the
  485.                     ``:'').
  486.  
  487.      LLLLiiiinnnneeeeWWWWrrrraaaapppp       Control whether long text lines are wrapper
  488.                     or truncated at the right hand margin.
  489.                     (Equivalent to the ----cccc option.)
  490.  
  491.      MMMMaaaaiiiillllUUUUsssseeeerrrr       The account name to use to login to a fax
  492.                     server when doing direct delivery.  Note that
  493.                     this account name is not used for the
  494.                     identity of the sender; this comes from the
  495.                     command line or the ``From'' line in the mail
  496.                     message.  If a null account name is
  497.                     specified, then the facsimile will be
  498.                     submitted using the identity of the user that
  499.                     invoked _f_a_x_m_a_i_l.
  500.  
  501.      MMMMaaaappppHHHHeeeeaaaaddddeeeerrrr      Define a substitution for the specified
  502.                     header that should be done each time the
  503.                     header is emitted in the formatted envelope.
  504.                     Header tags are matched in a case-insensitive
  505.                     manner.
  506.  
  507.      MMMMaaaarrrrkkkkDDDDiiiissssccccaaaarrrrddddeeeedddd  Control whether discarded MIME parts are
  508.                     replaced by a text message indicating the
  509.                     original content was removed.
  510.  
  511.      MMMMIIIIMMMMEEEECCCCoooonnnnvvvveeeerrrrtttteeeerrrrssss The pathname of a directory hierarchy that
  512.                     has scripts for external processing of MIME
  513.                     body parts.  The default pathname is
  514.                     /usr/freeware/sbin/faxmail.
  515.  
  516.      OOOOrrrriiiieeeennnnttttaaaattttiiiioooonnnn    Control whether pages are oriented
  517.                     horizontally (``landscape'') or vertically
  518.                     (``portrait'').  (Equivalent to the ----rrrr and ----RRRR
  519.  
  520.  
  521.  
  522. Page 8                                          (printed 6/24/99)
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529. FFFFAAAAXXXXMMMMAAAAIIIILLLL((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuullllyyyy 22222222,,,, 1111999999996666))))        FFFFAAAAXXXXMMMMAAAAIIIILLLL((((1111))))
  530.  
  531.  
  532.  
  533.                     options.)
  534.  
  535.      OOOOuuuuttttlllliiiinnnneeeeMMMMaaaarrrrggggiiiinnnn  Control whether columns of text have a line
  536.                     drawn around them and the width of the line.
  537.                     Setting this parameter to 0 disables
  538.                     outlines.
  539.  
  540.      PPPPaaaaggggeeeeCCCCoooollllllllaaaattttiiiioooonnnn  Control whether the output file has pages
  541.                     collated in the same order as the input file
  542.                     (``forward'') or in reverse order
  543.                     (``reverse).
  544.  
  545.      PPPPaaaaggggeeeeHHHHeeeeaaaaddddeeeerrrrssss    Control whether page headers are generated.
  546.  
  547.      PPPPaaaaggggeeeeHHHHeeeeiiiigggghhhhtttt     Set the output page height (in inches).
  548.  
  549.      PPPPaaaaggggeeeeMMMMaaaarrrrggggiiiinnnnssss    Set the output page margins.  Margins are
  550.                     specified as string of the form:
  551.                     ``llll====#,rrrr====#,tttt====#,bbbb====#'' where llll indicates the
  552.                     left margin, rrrr indicates the right margin, tttt
  553.                     indicates the top margin, bbbb indicates the
  554.                     bottom margin, and numbers are interpreted as
  555.                     _i_n_c_h_e_s.  (Equvalent to the ----MMMM option.)
  556.  
  557.      PPPPaaaaggggeeeeSSSSiiiizzzzeeee       Set the output page dimensions by name.
  558.                     (Equivalent to the ----ssss option.)
  559.  
  560.      PPPPaaaaggggeeeeWWWWiiiiddddtttthhhh      Set the output page width (in inches).
  561.  
  562.      PPPPrrrroooollllooooggggFFFFiiiilllleeee     The pathname of a file containing POSTSCRIPT
  563.                     that should be included in the prologue
  564.                     section of the generated POSTSCRIPT.  The
  565.                     default prologue file is
  566.                     /usr/freeware/lib/fax/faxmail.ps.
  567.  
  568.      TTTTaaaabbbbSSSSttttoooopppp        Set the tab stop distance (in characters).
  569.  
  570.      TTTTeeeexxxxttttFFFFoooonnnntttt       Set the name of font to use for setting text.
  571.                     (Equivalent to the ----ffff option.)
  572.  
  573.      TTTTeeeexxxxttttLLLLiiiinnnneeeeHHHHeeeeiiiigggghhhhtttt Set the vertical text line height and
  574.                     spacing.
  575.  
  576.      TTTTeeeexxxxttttPPPPooooiiiinnnnttttSSSSiiiizzzzeeee  Set the point size to use in setting plain
  577.                     text.  (Equvalent to the ----pppp option.)
  578.  
  579.      VVVVeeeerrrrbbbboooosssseeee        Control tracing envelope and MIME processing.
  580.  
  581. NNNNOOOOTTTTEEEESSSS
  582.      Because a sender's identity in an electronic mail message is
  583.      inherently untrustworthy, using _f_a_x_m_a_i_l to build a mail to
  584.      fax gateway is problematic.  Unless mail service is somehow
  585.  
  586.  
  587.  
  588. Page 9                                          (printed 6/24/99)
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595. FFFFAAAAXXXXMMMMAAAAIIIILLLL((((1111))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuullllyyyy 22222222,,,, 1111999999996666))))        FFFFAAAAXXXXMMMMAAAAIIIILLLL((((1111))))
  596.  
  597.  
  598.  
  599.      restricted or the sender's identity is verified using a
  600.      mechanism such as RFC 1847's multipart/signed MIME type
  601.      there is no reliable way to restrict access to facilities
  602.      setup with _f_a_x_m_a_i_l.
  603.  
  604. BBBBUUUUGGGGSSSS
  605.      Only the last instance of a header is kept and written to
  606.      the output.  This means, for example, that only the last of
  607.      many ``Received'' lines will be included in the formatted
  608.      output.
  609.  
  610. FFFFIIIILLLLEEEESSSS
  611.      ~/.hylarc                             per-user configuration file
  612.      /usr/freeware/lib/fax/pagesizes       page size database
  613.      /usr/freeware/lib/fax/faxmail.ps      POSTSCRIPT prologue
  614.      /usr/freeware/lib/fax/hyla.conf       system-wide configuration file
  615.      /usr/freeware/lib/fax/faxmail.conf    system-wide configuration file
  616.      /usr/freeware/lib/fax/sendfax.conf    system-wide configuration file for direct delivery
  617.      /usr/freeware/sbin/faxmail            hierarchy for external MIME converters
  618.      /usr/lib/DPS/AFM                      for font metrics
  619.      /usr/tmp/faxmailXXXXXX                temporary files
  620.  
  621. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  622.      _h_y_l_a_f_a_x(1), _t_e_x_t_f_m_t(1), _s_e_n_d_f_a_x(1)
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654. Page 10                                         (printed 6/24/99)
  655.  
  656.  
  657.  
  658.